home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / progtool / modula2 / m2d2 / rcsmaker / rsc2mod.txt < prev   
Text File  |  1995-11-25  |  5KB  |  114 lines
  1.  
  2.   >>> The *PSB-Modula-2/ST ResourceMaker <<<
  3.   
  4.  
  5.  *Pentagramm Software Braunschweig                                 14.05.92
  6.  
  7.  Thomas Birke           Hinnerk Rümenapf
  8.  birke@bii.bessy.de     Ottweilerstr. 18
  9.                         38116 Braunschweig
  10.  
  11.  Ein Programm von Thomas Birke
  12.  
  13.  Die Programme sind nach bestem Wissen und Gewissen getestet und für gut
  14.  befunden. Ich übernehme jedoch keine Gewähr für die Fehlerfreiheit,
  15.  der Software, und bin insbesondere nicht haftbar für eventuelle Schäden
  16.  oder Datenverluste, die durch die Programme verursacht wurden.
  17.  
  18.  Das Programm darf von jedem weitereggeben und genutzt werden, jedoch liegen
  19.  alle Rechte bei den Autoren.
  20.  
  21.  
  22. Resource-Datei und Resource-Einbindung
  23. ======================================
  24.  
  25. Resource-Datei
  26. --------------
  27.  
  28.  Die Informationen wie Menüzeile(n) und Dialogboxen aussehen werden 
  29.  normalerweise in RSC-Dateien abgelegt, die vom zugehörigen Programm geladen
  30.  werden.
  31.  In Sonderfällen (z.B. bei Accessories) ist dieses Verfahren jedoch unbequem,
  32.  oder führt sogar zu Problemen.
  33.  
  34.  
  35. Resource-Einbindung
  36. -------------------
  37.  
  38.  Die Alternative zu Resource-Dateien ist die direkte Einbindung der Daten in
  39.  das Programm. RSC2MOD setzt die Daten der RescorceDatei (.RSC) in einen
  40.  Modula2-Quelltext um. Die Information wird in Prozeduren geschrieben, die nur
  41.  Daten enthalten. Dazu ist es notwendig den Prozedurstart und -ende Code
  42.  wegzulassen. Im TDI-Modula2 geht das mit der Compiler-Option  (*$P-*)  vor
  43.  der Prozedur (s. die Datei  RSC2MOD.MSK ).
  44.  
  45.  Resource-Anpassung
  46.    Das direkte Einbenden der Resourcedaten hat auch Nachteile. Das AES passt
  47.    die Daten nach dem Laden automatisch an die Größe des System-Zeichensatzes
  48.    an. Bei eingebundenen Daten muß das durch eine Prozedur des Programms
  49.    geschehen (s. die Datei  RSC2MOD.MSK ).
  50.    Die Prozedur muß einmal aufgerufen werden nachdem das Programm sich beim
  51.    AES angemeldet hat. RSC2MOD erzeugt KEIN Definitionsmodul, es muß jedoch
  52.    nur die Prozedur  RelocateRSC  exportiert  werden. Existiert bereits ein
  53.    Definitionsmodul (z.B. mit den Objekt-Indices s.u.) muß nur die Prozedur
  54.     RelocateRSC  nachgetragen werden.
  55.    Die Prozedur  RelocateRSC  ist in mehrere Blöcke unterteilt. Es werden nur
  56.    die benötigten in die Ausgabedatei übernommen (s. Die Datei RSC2MOD.MSK).
  57.  
  58.  Resource-Indices
  59.    Die Programme zur Erstellung von Resource-Dateien erzeugen auch Dateien,
  60.    in denen die Indices der Objekte abgelegt sind. Für Modula2 wird
  61.    üblicherweise ein Definitionsmodul erzeugt.
  62.    An der Behandlung der Indices ändert sich NICHTS. Sie müssen nur
  63.    den Aufruf  ResourceLoad (...)  durch    RelocateRSC  ersetzen (s.o.),
  64.    und den Aufruf von  ResourceFree  weglassen. Sogar AES-Funktionen 
  65.    wie  ResourceGetAddr (...)  arbeiten dann einwandfrei.
  66.  
  67.  
  68. Die Datei RCS2MOD.MSK
  69. =====================
  70.  
  71.  Diese Datei enthält einen Rahmen, der mit den gelesenen Resource-Daten zur
  72.  Ausgabedatei kombiniert wird. Sie kann zur Anpassung an verschiedene Modula2
  73.  Systeme verändert werden. So muß evtl. zur Typumwandlung die Funktion  VAL 
  74.  verwendet werden, anstatt den neuen Typ als Funktion zu verwenden, die
  75.  Funktion  CODE  ist evtl. durch  INLINE  zu ersetzen, ... .
  76.  Wichtig ist dabei, daß die Bedeutung von Textstücken zwischen zwei  @ 
  77.  Symbolen nicht verändert wird. An den Stellen, an denen ein  @  in der Datei
  78.  steht, greift das Programm ein.
  79.  
  80.  Also: wenn Ihr Modula2-System Änderungen erfordert, beschränken Sie sich
  81.  (wenn möglich) auf die Importliste und die Funktionsnamen. Bevor Sie die
  82.  Datei verändern legen Sie eine Sicherungskopie des Originals an (das kann
  83.  nicht oft genug gesagt werden!).
  84.  
  85.  Die Datei RCS2MOD.MSK muß in demselben Verzeichnis stehen wie RCS2MOD.PRG.
  86.  
  87.  
  88. Extra
  89. =====
  90.  
  91.  RSC2MOD arbeitet mit dem M2OPTIONS-Accessory des TDI-Modula2 Systems
  92.  zusammen.
  93.  Die mitgelieferte Datei RSC2MOD.MSK ist an die Eigenheiten des TDI-Modula2
  94.  angepasst.
  95.  
  96.  
  97. WARNUNG
  98. =======
  99.  
  100.  Die Ausgabedatei überschreibt gnadenlos (aber nach Rückfrage) eine evtl.
  101.  schon vorandene Datei gleichen Namens. Passen sie also auf Ihre Quelltexte
  102.  auf. Spendieren Sie ein extra-Modul für die Resource!
  103.  
  104. Alle unsere Programme werden auf Herz und Nieren getestet, um soviele Fehler
  105. wie möglich zu beseitigen. Wir können trotzdem keine Garantie übernehmen,
  106. daß die Programme vollständig fehlerfrei sind. Insbesondere haften wir nicht
  107. für Datenverluste oder andere Defekte, die auf Programmfehler in unseren 
  108. Produkten zurückzuführen sind. Es können keine Schadensersatzansprüche an
  109. uns geltend gemacht werden.
  110.  
  111. Doku von HWR
  112.  
  113. +++
  114.